home *** CD-ROM | disk | FTP | other *** search
/ SGI MineSet 2.5 / SGI MineSet 2.5.iso / docs / insight / SGI_bookshelves / Help / books / LicMgrHelp / styles / README < prev    next >
Encoding:
Text File  |  1998-05-12  |  3.2 KB  |  87 lines
  1.  
  2. This directory contains the master sources for the stylesheets necessary
  3. for building and viewing a book.
  4.  
  5. These are the structure viewer style sheets:
  6.  
  7. bigfont.v - this stylesheet increases the fulltext.v by 2 points
  8. fulltext.v - this is the primary standard style sheet
  9. smallfont.v - the default for PI's and hi res monitors - decreases font by 2
  10. tinyfont.v - this stylesheet decreases smallfont.v by 2 points
  11. debug.v - this is the fulltext stylesheet with color added for character tags
  12.  
  13.  
  14. These are the table of contents style sheets - any change to these style
  15. sheets requires the book to be rebuilt.
  16.  
  17. toc.tv - the standard tble of contents
  18. figures.tv - the list of figures
  19. tables.tv - the list of tables
  20.  
  21. Each of toc, figures, and tables has a big, small, and tiny.
  22. These sizes match the font sizes as well, but must be generated by hand.
  23. It should be possible to have the entities match when using gdiff but
  24. be careful.
  25.  
  26. This is the style sheet for printing the books
  27.  
  28. fulltext.pv - based on smallfont but switches square bullets to bullets for
  29.           printing purposes since the symbol's font doesn't have square
  30.  
  31.  
  32. The following style sheets are for restricted viewers:
  33.  
  34. frontmatter - this is for the Copyright frontmatter
  35. bobindex - this is for the back of the book index
  36.  
  37.  
  38. When modifying these stylesheets several rules must be followed.
  39. 1) if new styles are added, they are added to fulltext.v first then
  40.    added to bigbont.v, smallfont.v, and tinyfont.v by using gdiff
  41. 2) if these new styles need to go in a structure viewer those .tv
  42.    files must then be edited - very carefully with gdiff
  43. 3) if styles must be changed then only make the changes in fulltext.v
  44.    then follow step 1 again.
  45. 4) Try to keep the stylesheets as simple as possible - don't define every
  46.    style for a ToC since only titles belong in them - so those must be
  47.    built by hand
  48.  
  49. NOTE:  It is easier if one edits the fulltext.v file first using insted,
  50. then goes in and "sorts" the top entities (vi and "!{sort +1" works great)
  51. Then if one uses gdiff on each of the .v files one selects the new file
  52. and only accepts the changes from the fulltext.v file that were just made.
  53. This process makes maintanance much easier with no hand editing of the
  54. files necessary.
  55.  
  56.  
  57.  
  58. Here is the rationale for the font sizes in the various style sheets.
  59.  
  60. 1) the basic fonts available on every machine come in 8, 10, 12, 14, 18, and 24
  61. 2) the various monitors have differing resolutions
  62.  
  63.     Screen size        Starter        Express
  64.     14"         108dpi         N/A
  65.     16"          88dpi         111dpi
  66.     19"          72dpi           ?
  67.     20"          N/A          91dpi
  68.  
  69.     PI          96dpi           ?
  70.  
  71. 3) InSight will make a "best guess" as to which style sheet would look "best"
  72.    on each monitor
  73. 4) based on this there are 4 different sizes of the basic style sheet, the
  74.    table shows the various font sizes for the various tags
  75.  
  76.    Tag name        std font   bigfont   smallfont  tinyfont
  77.    DOC,TITLE          24        24        18      14
  78.    CHAPTER,TITLE      18        24        14      12
  79.    SECTION1,TITLE      14        18        12      10
  80.    SECTION2,TITLE      14        18        12      10
  81.    SECTION3,TITLE      12        14        10       8
  82.    BODY text          12        14        10       8
  83.  
  84. The distinction between a SECTION1 and SECTION2 TITLE is by the spacing
  85. before and after the title itself - not in the font size.  All titles
  86. are bold.
  87.